home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / xjewel / README < prev    next >
Text File  |  1995-05-03  |  7KB  |  220 lines
  1. ==============================================================================
  2.  
  3.                 #
  4.                #  ######  #    #  ######  #
  5.               #  #       #    #  #       #
  6.              #  #####   #    #  #####   #
  7.           #     #  #       # ## #  #       #
  8.          #     #  #       ##  ##  #       #
  9.          #####   ######  #    #  ######  ######
  10.  
  11. ==============================================================================
  12.  
  13. This game was originally written by Yoshihiro Satoh of HP.  I have made a
  14. modest attempt to replicate Domain/JewelBox under X.
  15.  
  16. I have somewhat rudely taken the bitmaps from the original game and
  17. created this version.  I hold the copyright for the code, as I created
  18. it, but I hold no claim to the bitmaps which were freely
  19. distributed with the Domain version.
  20.  
  21. REDISTRIBUTION in source or binary from is permited as long as adequate
  22. notation of the originators is retained, including the developer of the 
  23. original Domain/Jewlbox, Yoshihiro Satoh.
  24. NOTE: I do not claim to hold any copyright on columns games, Jewelbox, or any
  25. related name or icon.  I have written the source and thats all I hold claim to.
  26.  
  27. USE AT YOUR OWN RISK AND PERIL, I MAKE NO CLAIM OF USEABILITY OR WARANTY.
  28.  
  29. BUILDING
  30. ========
  31.  
  32. Jewel SHOULD compile on any UNIX or VMS machines:
  33.  
  34. UNIX:
  35. In order to build xjewel:
  36.     1) edit the Imakefile to taste.
  37.         NOTE if you do not have imake use the file Makefile.simple and skip 2)
  38.             Worthwhile defines:
  39.                 USE_SELECT - for the BSD crowd
  40.                         (define if build fails to find the poll system call)
  41.                 ICON_WINDOW - for a dynamic icon window rather than static
  42.                 DECWM - for a site using the DECwindows session manager
  43.     2) build the make file -> xmkmf or imake...
  44.     3) build the font: ( NOTE: only if desired, the game will run with out it )
  45.         % make bitmaps/seven_seg.snf
  46.     % xset +fp <curr path>
  47.     NOTE:   the xset will work only when you are local to the X-server,
  48.         on networked machines you have to add the font to the servers
  49.         font directories as appropriate...
  50.         AGAIN: The game will play without it.
  51.     4) make the program:
  52.         % make 
  53.     5) install and make the scorefile:
  54.     % copy xjewel ``your exec dir''/xjewel
  55.     % chmod a-w ``your exec dir''/xjewel
  56.         % touch ``your scorefile dir''/xjewel.scores
  57.         % chmod a+w ``your scorefile dir''/xjewel.scores
  58.     OR:
  59.     % make install
  60.     6) and enjoy....
  61. also:
  62.     7) Please edit the man page to show the exe path if desired, and install.
  63.     % copy xjewel.man /usr/local/man/man6/xjewel.6
  64.     OR:
  65.     % make install.man
  66.  
  67. I have been able to build this on ISC 3.0, HP-UX 8.02, Ultrix 4.2, Solaris 1.0,
  68. Domain X11R4, and OSF1.0.  All have functioned as expected.
  69.  
  70. It reportedly builds on Dell SVR4 v2.1, and several other un-named machines.
  71.  
  72. VMS:
  73.     1) edit make.com to setup HSCORE_FILE
  74.     2) build both the font and executable:
  75.         @make.com
  76.     3) install the program and font
  77.     % copy xjewel.exe ``your local exec area''
  78.     % copy xjewel.hlb ``your local help area''
  79.     % copy [.bitmaps]seven_seg.* ``your local font area''
  80.         NOTE: new fonts may require restarting your x-server
  81.     4) and enjoy....
  82.  
  83. I have been able to build this on VMS V5.5 and run with DECwindows.
  84.  
  85. There is a man page in xjewel.man and a ps version in xjewel.ps.
  86.  
  87. PLAYING
  88. =======
  89.  
  90. Jewel is a game much like Domain/Jewelbox which is a puzzle game like
  91. Tetris.
  92.  
  93. It is played by controling the motion of blocks which continue to fall from
  94. the top of the screen.  One can move them left and right, as well as
  95. rotate the jewel segements.  The object is to get the most points before
  96. the grim reaper ends the fun.
  97.  
  98. Death happens when the screen is no longer capable of holding any more
  99. blocks.  To make high scores more interesting, you are given but three
  100. attempts to get points -- use them wisely.
  101.  
  102. As the game progresses, and more jewels are removed, the speed of the game
  103. will increase.  This is measured in seconds of delay between steps of
  104. block motion.
  105.  
  106. Keys
  107. ----
  108. There are three sets of keys that can be used:
  109. ( or any combination )
  110.  
  111. Option 1:
  112.          +---+ +---+ +---+
  113.          | j | | k | | l |
  114.          +---+ +---+ +---+
  115.            ^     ^     ^
  116.            |     |     |__ move block right
  117.            |     |________ rotate block
  118.            |______________ move block left
  119.  
  120.          +---------+
  121.          |  SPACE  | <---- drop block
  122.          +---------+
  123.  
  124. Option 2:
  125.          +---+ +---+ +---+
  126.          | 4 | | 5 | | 6 |
  127.          +---+ +---+ +---+
  128.            ^     ^     ^
  129.            |     |     |__ move block right
  130.            |     |________ rotate block
  131.            |______________ move block left
  132.  
  133.          +---------+
  134.          |    0    | <---- drop block
  135.          +---------+
  136.  
  137. Option 3: (cursor keypad)
  138.                 
  139.                +---+
  140.                | ^ | <----  rotate block
  141.                +---+
  142.          +---+ +---+ +---+
  143.          | < | | V | | > |
  144.          +---+ +---+ +---+
  145.            ^     ^     ^
  146.            |     |     |__ move block right
  147.            |     |________ drop block
  148.            |______________ move block left
  149.  
  150.  
  151. Rotations
  152. ---------
  153. The folowing rotations are possible:
  154. ( there are no others )
  155.  
  156.               +---+       +---+       +---+
  157.               | 1 |       | 3 |       | 2 |
  158.               +---+       +---+       +---+
  159.               | 2 |  ==>  | 1 | ==>   | 3 |
  160.               +---+       +---+       +---+
  161.               | 3 |       | 2 |       | 1 |
  162.               +---+       +---+       +---+
  163.  
  164.  
  165.  
  166. SCORING
  167. =======
  168.  
  169. The basic way to get points is to unite the jewels to form triplet (or
  170. higher) matches.  This can be done in any direction, and can be
  171. accomplished in more than one part of the board at one time.  As the
  172. jewels are removed, the board falls to fill the spaces -- matches may
  173. again occur.
  174.  
  175. These teritiary matches provide an interesting part to the game due to the
  176. formula for calculating points:
  177.     
  178.     ( 300 (for base triplet) + 150 * (each additional jewel) ) * 2^order
  179.  
  180.     where order is the number of the repeition from which the match
  181.     occured.
  182.  
  183. As a light at the end of the bleak tunnel, a WILD CARD is available.  The
  184. wild block will be given at infrequent intervals, and will give the user
  185. the points for one triplet by removing all the jewels of a particular
  186. shape/color.
  187.  
  188. To add some interest to the game, points are awarded for dropping the
  189. block from a height above its resting place.  This is accumlated at 10
  190. points per level above the place it will rest.
  191.  
  192. Stages
  193. ------
  194. There are no changes for the higher levels, although the speed increases,
  195. proportionaly to the level.  Stage increases with the successful
  196. completion of the 50 jewels required per level.  The current status is
  197. shown in the REST field.
  198.  
  199.  
  200. ORIGINAL NOTATIONS
  201. ==================
  202. >Authors
  203. >-------
  204. >
  205. >   Programming       Yoshihiro Satoh
  206. >   Font Design       Yoshiharu Minami
  207. >   Document Writing  Nancy Paisner
  208. >
  209. >Copyright
  210. >---------
  211. >
  212. >  This software is in the Yoshihiro's Arcade Collections.
  213. >  Domain/JewelBox is a trade mark of Yoshihiro Satoh.
  214. >
  215. >  Copyright @ 1990 by Yoshihiro Satoh
  216. >  All rights are reserved by Yoshihiro Satoh.
  217.  
  218. xjewel - Jewel for X11 Copyright 1992 by David Cooper
  219.  
  220.